This page last changed on Jan 02, 2007 by rosie@atlassian.com.

You need to edit in 'Wiki Markup' mode to include macros in your page.

The Gallery Macro creates a gallery of thumbnails from all the images that are attached to a page and displays them in a tabular format. Clicking on the thumbnail opens up the full-size image in a new window. You can also view the images as a slideshow by clicking the 'View as Slideshow' link located below the title.

You can specify a title for the gallery and also configure how many columns you want for the table in which your images are displayed. Confluence automatically displays the corresponding comment below the image.

Confluence only creates thumbnails of images in these file formats:gifs, pngs and jpegs. The bmp format is not supported.

To use the gallery macro, simply include the following markup in your page and replace the title with your own.

Gallery Macro

What you need to type
{gallery:title=Some office photos, and a waterfall}{gallery}
What you will get

Some office photos, and a waterfall
(view as slideshow)
         
      Here's an office photo  
 
         
        Here is the waterfall photo
 


The default number of columns for the table is 4.


Optional Parameter

No  parameter Default Description
 1 columns 4 Specify the number of columns for your table
 2 slideshow true Disable slide show option

Specify the number of columns for your table

{gallery:columns=3|title=Some office photos, and a waterfall}{gallery}

Disable slide show option

By default, Confluence displays the link to view the images as a slideshow. To disable this link, include the following code within the macro:

{gallery:slideshow=false}
RELATED TOPICS

Displaying an Image
Thumbnail Macro
Attaching Files to a Page
Editing Attachment Details
Working with Macros

Take me back to Confluence 2 Home


harbour2.jpg (image/jpeg)
harbour3.jpg (image/jpeg)
office10.jpg (image/jpeg)
office11.jpg (image/jpeg)
office3.jpg (image/jpeg)
office1.jpg (image/jpeg)
office2.jpg (image/jpeg)
waterfall.jpg (image/jpeg)

This gallery macro is great!

Is it possible to control the order of the photos' display?  It looks like it goes in the order in which the files were attached to the page.

If it is not possible to modify the gallery macro, is it possible to support changing the order of the files in the attachments collection?  I suppose I could remove them all, and then add them in the desired order, but I would like to avoid that if possible.

Thanks,
Keith

Posted by keithrbennett at Dec 30, 2005 15:35

There is a feature request already open on Atlassian's JIRA. If you can comment and vote for it, that would help raise the priority of this request.

Posted by gfraser at Dec 31, 2005 11:14

I to like this feature, just wondering how I would control the size of the window opened for the photos.

I have tried making the photos smaller in size, but they still open in a window larger than my screen.

Am I missing something?

Allan

Posted by allan.d.voltz@boeing.com at Mar 14, 2006 22:40

What mechanism/algorithm is used to determine the order? I appreciate that there is currently no support for specifying this manually but if i knew the algorithm i could change the attachment names to get the order i want...

Posted by skaze at Jun 22, 2006 11:36

Just voting for John's question. I tried to create a slideshow out of a powerPoint presentation, but the slides are stubbornly show in wrong order. Best option would be to have a parameter to deceide whether you want the pictures to be shown in alphabetical order, according the time of creation or in another order.

-Tomi Nummi 

Posted by tomi.nummi@sulake.com at Aug 23, 2006 03:25

Agreed, some help here would be good. I've tried ensuring the alphabetical order and upload order but it completely refuses to the pics in any kind of useful order. I had to resort to listing the thumbnails myself:

!image1.gif|thumbnail! !image2.gif|thumbnail! !image3.gif|thumbnail!

Thus losing the great extras of the gallery (slideshow, auto inclusion of new images).

How does it decide?

Posted by xurf at Sep 08, 2006 17:38

It would be nice to have clearer information for newbies about how this macro is to be used. Such as, the images displayed are taken from attachments (i.e. nothing goes between {gallery} and {gallery}). Also, picture titles come from the attachment comment field.

Posted by cjackson@ci.tacoma.wa.us at Oct 06, 2006 11:34

Hmmm... A closer reading reveals that this information is included. However, I do think it could be made a little clearer for beginners.

Posted by cjackson@ci.tacoma.wa.us at Oct 06, 2006 11:38
Document generated by Confluence on Feb 05, 2007 23:34